home *** CD-ROM | disk | FTP | other *** search
/ LOGIC Apps / Logic-APPLE_II_APPS.iso / mac / LOGIC Apple II 5.25" Library - ProDOS / PRO038A.dsk / PLATOON.DOC.txt < prev    next >
Text File  |  2012-02-16  |  9KB  |  182 lines
  1.                             TANK PLATOON
  2.  
  3.          TANK PLATOON is a wargame of tactical-level combat between
  4. small groups consisting of tanks, infantry, personnel carriers,
  5. self-propelled artillery, and leaders. It will run on any Apple II 
  6. series computer with at least 64K and a disk (or Ramdisk) capable of 
  7. holding 350 ProDOS blocks. A color monitor and 128K are recommended. 
  8. This documentation file contains the following information:
  9.  
  10.          a.  Brief description of the game.
  11.          b.  Downloading procedure.
  12.          c.  Technical notes on program design.
  13.          d.  Other comments.
  14.  
  15.  
  16. A. DESCRIPTION OF GAME
  17.  
  18.          TANK PLATOON may be played as a two-player game, or played 
  19. against the computer. Each player chooses ten units, which may be any 
  20. combination of tanks, infantry, artillery, personnel carriers, and 
  21. leaders. Players alternate, with the first player using one of his 
  22. units until its time is expended, then the second player using one of 
  23. his units, etc., until all units have been used, at which time the game
  24. turn ends. Each unit can perform various actions, such as observing the
  25. surrounding area, reloading its weapon, reading the map, preparing a 
  26. minefield, moving into an adjacent area, or calling for fire support 
  27. against adjacent targets. Each action takes a certain amount of time, 
  28. and each unit can be used until its six-minute turn has been exhausted.
  29.  
  30.          The object of the game is to locate and destroy enemy units. 
  31. When the game begins, players know only the general direction from
  32. which the enemy units will be approaching. The battle area is a 20 by 
  33. 30 grid, with each square representing an area approximately one 
  34. hundred meters square. Only one unit can occupy a square, except when 
  35. infantry or leader units are inside a personnel carrier. Combat occurs 
  36. when a unit attempts to enter a square occupied by an enemy unit. 
  37. Players can establish ambush zones and wait for the enemy to arrive, or
  38. they can send tanks and personnel carriers to raid the enemy positions.
  39. The most powerful force is usually a combination of the various unit 
  40. types, since each type has different capabilities.
  41.  
  42.          Infantry units are equiped with a rifle, an anti-tank missile,
  43. and a supply of mines. They can be resupplied from personnel carriers. 
  44. They can prepare defensive positions and call for artillery fire 
  45. against adjacent areas.
  46.  
  47.          Tanks have machine guns and cannons. They can fire at targets 
  48. located by other units, but they cannot designate targets for other 
  49. units. They cannot be damaged by machine gun fire, but if their 
  50. hatches are open, their crew can be injured by machine gun fire or 
  51. artillery near-misses. They must open hatches (unbutton) to observe the
  52. surrounding areas.
  53.  
  54.          Personnel carriers are equiped with heavy (25mm) machine guns,
  55. and can carry up to four infantry or leader units. They can designate 
  56. artillery targets, and can resupply any units inside them. They are not
  57. as heavily armored as tanks.
  58.  
  59.          Leaders are similar to infantry units, but do not carry
  60. anti-tank missiles or mines. Only leaders can read the map, which shows
  61. the location of friendly units, friendly minefields, and destroyed 
  62. vehicles. Leaders can call for "off-map" artillery fire, which arrives
  63. immediately.
  64.  
  65.          Self-propelled artillery units possess enormous firepower, but
  66. are best used to attack distant targets designated by other units. 
  67.  
  68.          When a unit observes the surrounding area, it sees into the
  69. adjacent areas shown below:
  70.  
  71.                                North
  72.  
  73.                              A B C D E
  74.                              F G H I J
  75.                 West         K L M N O         East
  76.                              P Q R S T
  77.                              U V W X Y
  78.  
  79.                                South
  80.  
  81.          A unit in area M will first look toward the North, and will
  82. see whatever is in areas G, H, and I. If any of theses areas is clear
  83. or prepared, he will also see into the area beyond it: for example,
  84. if area I, to the northeast of area M, is clear, he will see into areas
  85. D and E. Next, he will face East, and will see into areas I, N, and S. 
  86. Note that area I is seen twice, and if area I is clear, area E will be 
  87. seen twice. The unit next faces South, looking into areas S, R, and Q 
  88. (S is on the left of the screen), and finally faces West, looking into areas
  89. Q, L, and G. It sounds complicated, but you will find it easy in practice.
  90.  
  91.  
  92. B. DOWNLOADING PROCEDURE
  93.  
  94.          TANK PLATOON is provided on one 3.5" disk or two 5.25" disks,
  95. formatted under ProDOS.  If you do not have a large capacity disk drive 
  96. (ie. 800k 3.5" or a hard disk), then you will need a large RAM disk which 
  97. has at least 350 blocks under ProDOS, or about 175k free.  You can simple copy
  98. the files to your RAM disk with any file copy utility program.
  99.  
  100.          The sixteen files which make up the game must all be kept 
  101. within the same ProDOS directory (or subdirectory). The fastest 
  102. way to play is to load all the files into a ramdisk, since the 
  103. game involves lots of disk access. However, it is easier simply to keep
  104. the files on a 3.5 disk; most of the time involved in playing the game
  105. is spent wondering what to do next to stop the relentless advance of
  106. enemy tanks.  When using a RAM disk, it is best to use one named "/RAM".
  107.  
  108.          The programs use the default prefix (or Volume name);
  109. they will not look outside the current directory to find each other.
  110. If you want the game to be on a bootable disk, you will need to store 
  111. PRODOS 1.1.1 and BASIC.SYSTEM on the disk with them. (Do not use newer 
  112. versions of ProDOS. The game does several pokes to correct bugs in
  113. version 1.1.1, and these pokes may cause undocumented features in other
  114. versions.) To start the game, boot the disk or load and run STARTUP.
  115. You will need to reboot when you are done, since several internal pointers
  116. are left with non-standard settings.
  117.  
  118.  
  119. C. TECHNICAL NOTES
  120.  
  121.          TANK PLATOON is written almost entirely in Applesoft. The code
  122. is commented, and users are encouraged to make modifications. The main 
  123. program, "PLATOON.", presents the players with options and keeps track 
  124. of wounding, morale, supplies, location, and other unit 
  125. characteristics. When some options are selected, such as observing the 
  126. area or reading the map, other programs are CHAIN'ed into memory. 
  127. Programs which use high-res graphics are loaded above HGR1. An area 
  128. starting at $800 is used for shape tables and a few machine language 
  129. routines.
  130.  
  131.          The programs will use 64K of auxiliary memory, if available, 
  132. as a /RAM volume to store the longer programs, so that disk reading 
  133. time is reduced. The game can be saved at the end of each game turn as 
  134. a VAR file (hurray for ProDOS!) Only one game can be saved at a time, 
  135. unless you make several copies of the game.
  136.  
  137.          Initial unit characteristics (ammo supply, morale, mobility, 
  138. etc.) are set in the program SEL, and the terrain is set in the program
  139. INIT. Terrain types are: 1 = clear, 2 = light forest, 3 = medium
  140. forest, 4 = dense forest, 5 = prepared (foxhole). In addition, terrain 
  141. can include destroyed vehicles of the three types, and minefields.
  142.  
  143. The programs have the following names, lengths, and functions:
  144.  
  145.          PLATOON.  19135     Main program, movement, options
  146.          HEXNO     13530     Shows adjacent areas, checks map edge
  147.          CT         5468     Controls computer's movements
  148.          RET        6629     Controls retreat, victory points
  149.          OP.VIEW    6223     Shows view of attacker
  150.          RMAP       3280     Displays map
  151.          TPS.2      1952     Shape table
  152.          STARTUP   10455     Logo, sets up memory pointers
  153.          V.ARM      7198     Resolves attacks on armour
  154.          V.INF      8060     "        "         infantry, leaders
  155.          V.APC      8308     "        "         personnel carriers
  156.          V.SP       5376     "        "         artillery
  157.          SGAME       471     Saves game for future play
  158.          INIT       6503     Sets up terrain, scenarios
  159.          SEL        6451     Allows selection of unit types
  160.          STAT       7368     Displays game status
  161.  
  162.          After combat, the program RET runs to check whether the
  163. defending unit retreats. It the defender was destroyed, points are 
  164. awarded to the attacking player, and the program STAT checks the points
  165. at the end of each turn to see if the game has been won. Modifications 
  166. may be made in these programs, if the user feels the game has treated 
  167. him unfairly. 
  168.  
  169.  
  170. D. OTHER COMMENTS
  171.  
  172.          TANK PLATOON is copyrighted, but I don't mind if you give
  173. copies away. Commercial rights are reserved. I want people to play the 
  174. game. Tank Platoon was previously available here as several individual 
  175. files, but the difficulty of downloading and combining the files was 
  176. too extreme. The present Binary II version, however, can only be 
  177. used by players with large-capacity disk drives.
  178.          If anyone wants a set of tested programs on floppy disks and a
  179. manual, he can send $25.00 to me at P.O. Box 236, Deep River, CT 
  180. 06417. I welcome suggestions and complaints.
  181.                    Gareth Tucker, 74375,464
  182.